home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 31 / CDASC_31_1996_juillet_aout.iso / vrac / bascinst.zip / š›œ.EXE / INSTALL.DOC next >
Text File  |  1996-05-26  |  13KB  |  325 lines
  1.                              
  2.                              
  3.                              
  4.                              The Basic Installer
  5.                                      v1.0
  6.  
  7.                              
  8.                              
  9.                              
  10.                               by: °FireZone Ent.
  11.         
  12.         
  13.      1.0 About The Basic Installer
  14.         
  15.      2.0 The Programming Language
  16.      2.1 Appearance
  17.      2.2 Running Other Programs
  18.      2.3 Advanced Features
  19.      2.4 Command Summaries
  20.  
  21.      3.0 License Agreements and Ordering Info.
  22.  
  23.  
  24. 1.0 About The Basic Installer
  25.  
  26.     The Basic Installer was written by °FireZone Ent. for the purpose of
  27. distributing software. We realized that scince this is such a useful file,
  28. we spruced it up and are distributing it. If it recieves great reviews, we
  29. will make it better, and sell it. Payment will be by check only.
  30.     
  31.     This program is powerful enough the meet the needs of any small time
  32. software creator. With the ability to draw boxes, locate text, change the
  33. foreground and background color, beep, run external programs, etc. This is
  34. the ideal install program for any programmer.
  35.  
  36.  
  37.  
  38. 2.0 The Programming Language
  39.  
  40.     The Basic Installer reads the script file INSTALL.SCR to run. You will
  41. find that the language to this program is very similar to the Basic language.
  42. If you know Basic or Batch, you will conquer this in a few minutes.
  43.  
  44. P.S. If the file INSTALL.SCR is not present, you're gonna get some errors.
  45.  
  46.  
  47. 2.1 Appearance
  48.  
  49.     The Appearance is very important to many people, because the appearance
  50. often sells a product. Thus you will want to make an appearance as impressive
  51. as possible. The following are statements that can be used to affect the
  52. appearance of the Installation of your product:
  53.  
  54.      CLS
  55.      BOX
  56.      MODE
  57.      DISP
  58.      FCOLOR
  59.      BCOLOR
  60.      LOCATE
  61.  
  62. CLS: Just as in Batch or Basic, it will clear the screen.
  63.     
  64. BOX: The box statement will draw a shadow box on the screen using the
  65.     parameters you specify. The systax is as follows:
  66.     
  67.     BOX forcolor, backcolor, startline, startcol, endline, endcol
  68.  
  69.     Example:
  70.     BOX 4,0,8,25,16,55
  71.  
  72.     That will draw a red box from coordinates 8,25 to 16,55. Text is now
  73.     the color black, because the text appears as the background on the box.
  74.     The box size and appearance and color options are directly effected by
  75.     the screen mode (MODE statement). Another way to type it is:
  76.     BOX ,,8,25,16,55 That will not effect colors (it will reverse the box's)
  77.  
  78.  
  79. MODE: The same as SCREEN in QBasic.
  80.  
  81. The following table summarizes screen modes:
  82.  
  83. ──────────MDPA, CGA, Hercules, Olivetti, EGA, VGA, or MCGA Adapters───────────
  84. MODE 0: Text mode only
  85.     ■ 40 x 25, 40 x 43, 40 x 50, 80 x 25, 80 x 43, or 80 x 50 text format,
  86.       8 x 8 character box (8 x 14, 9 x 14, or 9 x 16 with EGA or VGA)
  87.     ■ 16 colors assigned to any of 16 attributes (with CGA or EGA)
  88.     ■ 64 colors assigned to any of 16 attributes (with EGA or VGA)
  89.     ■ Depending on the text resolution and adapter, 8 video memory pages
  90.       (0-7), 4 pages (0-3), 2 pages (0-1), or 1 page (0)
  91.  
  92. ───────────────────────CGA, EGA, VGA, or MCGA Adapters────────────────────────
  93. MODE 1: 320 x 200 graphics
  94.     ■ 40 x 25 text format, 8 x 8 character box
  95.     ■ 16 background colors and one of two sets of 3 foreground colors
  96.       assigned using COLOR statement with CGA
  97.     ■ 16 colors assigned to 4 attributes with EGA or VGA
  98.     ■ 1 video memory page (0)
  99. MODE 2: 640 x 200 graphics
  100.     ■ 80 x 25 text format, 8 x 8 character box
  101.     ■ 16 colors assigned to 2 attributes with EGA or VGA
  102.     ■ 1 video memory page (0)
  103.  
  104. ─────────────────────Hercules, Olivetti, or AT&T Adapters─────────────────────
  105. MODE 3: Hercules adapter required, monochrome monitor only
  106.     ■ 720 x 348 graphics
  107.     ■ 80 x 25 text format, 9 x 14 character box
  108.     ■ Usually 2 video memory pages (0-1); 1 page (0) if a second color
  109.       display adapter is installed
  110.     ■ PALETTE statement not supported
  111.     ■ Invoke the Hercules driver MSHERC.COM before using screen mode 3
  112. MODE 4:
  113.     ■ Supports Olivetti Personal Computers models M24, M240, M28, M280,
  114.       M380, M380/C, and M380/T and AT&T Personal Computers 6300 series
  115.     ■ 640 x 400 graphics
  116.     ■ 80 x 25 text format, 8 x 16 character box
  117.     ■ 1 of 16 colors assigned as the foreground color (selected by the
  118.       COLOR statement); background is fixed at black
  119.     ■ 1 video memory page (0)
  120.     ■ PALETTE statement not supported
  121.  
  122. ─────────────────────────────EGA or VGA Adapters──────────────────────────────
  123. MODE 7: 320 x 200 graphics
  124.     ■ 40 x 25 text format, 8 x 8 character box
  125.     ■ Assignment of 16 colors to any of 16 attributes
  126.     ■ If 64K EGA adapter memory, 2 video memory pages (0-1); otherwise,
  127.       8 pages (0-7)
  128. MODE 8: 640 x 200 graphics
  129.     ■ 80 x 25 text format, 8 x 8 character box
  130.     ■ Assignment of 16 colors to any of 16 attributes
  131.     ■ If 64K EGA adapter memory, 1 video memory page (0); otherwise,
  132.       4 pages (0-3)
  133. MODE 9: 640 x 350 graphics
  134.     ■ 80 x 25 or 80 x 43 text format, 8 x 14 or 8 x 8 character box
  135.     ■ 16 colors assigned to 4 attributes (64K adapter memory), or
  136.       64 colors assigned to 16 attributes (more than 64K adapter memory)
  137.     ■ If 64K EGA adapter memory, 1 video memory page (0); otherwise,
  138.       2 pages (0-1)
  139.  
  140. ─────────────────EGA or VGA Adapters, Monochrome Monitor Only─────────────────
  141. MODE 10: 640 x 350 graphics, monochrome monitor only
  142.     ■ 80 x 25 or 80 x 43 text format, 8 x 14 or 8 x 8 character box
  143.     ■ Up to 9 pseudocolors assigned to 4 attributes
  144.     ■ 2 video memory pages (0-1), 256K adapter memory required
  145.  
  146. ─────────────────────────────VGA or MCGA Adapters─────────────────────────────
  147. MODE 11 (VGA or MCGA)
  148.     ■ 640 x 480 graphics
  149.     ■ 80 x 30 or 80 x 60 text format, 8 x 16 or 8 x 8 character box
  150.     ■ Assignment of up to 256K colors to 2 attributes
  151.     ■ 1 video memory page (0)
  152. MODE 12 (VGA)
  153.     ■ 640 x 480 graphics
  154.     ■ 80 x 30 or 80 x 60 text format, 8 x 16 or 8 x 8 character box
  155.     ■ Assignment of up to 256K colors to 16 attributes
  156.     ■ 1 video memory page (0)
  157. MODE 13 (VGA or MCGA)
  158.     ■ 320 x 200 graphics
  159.     ■ 40 x 25 text format, 8 x 8 character box
  160.     ■ Assignment of up to 256K colors to 256 attributes
  161.     ■ 1 video memory page (0)
  162.  
  163. DISP: The same as ECHO in Batch. But, you can't specify environment variables
  164.     like %PATH% because Install doesn't interface with the DOS environment.
  165.     DISP is often used with the LOCATE statement, and is required to be
  166.     preceded by the LOCATE statement if you want to display text in a BOX.
  167.     The text color is effected by the "backcolor" in the BOX statement.
  168.     Use FCOLOR to change the text color, and BCOLOR to change the background.
  169.  
  170. FCOLOR: Changes the Foreground color. It is directly effected by the MODE
  171.    statement and the BOX statements "backcolor" parameter. Valid: 0-15
  172.      FCOLOR 7 (will change text the color to plain white)
  173.  
  174. BCOLOR: Changes the Background color. It is directly effected by the MODE
  175.    statement and the BOX statements "forcolor" parameter. Valid: 0-7
  176.      BCOLOR 1 (will change the background color to blue)
  177.  
  178. LOCATE: Just like LOCATE in QBasic. LOCATE 2,6 (changes to the 2nd Row, and
  179.    6th column).
  180.  
  181.  
  182. 2.2 Running Other Programs
  183.  
  184.     Running other programs is required to install your files. If you made an
  185. archive containing your files, you will want to run it to extract your files
  186. into the specified directory. There are two ways to run your programs:
  187.  
  188.      EXEC commandline
  189.      EXEC+INPUT commandline
  190.  
  191. EXEC: Will run the commandline exactly as typed. Spaces and pipes are valid
  192.     and accepted charactors in the command line.
  193.  
  194. EXEC+INPUT: must be typed exactly as you see it. This is exactly like EXEC,
  195.     but one added bonus. After using the INPUT statement, this will add it
  196.     at the end of the commandline. For example:
  197.      If INPUT contains the line: C:\INSTALL, this is what happens:
  198.      Type: EXEC+INPUT EXTRACT -O
  199.      Install executes: "EXTRACT -O C:\INSTALL"
  200.     Do you see the benefit? Good. Read about INPUT to learn more.
  201.  
  202.  
  203. 2.3 Advanced Features:
  204.  
  205.     These advanced features are extremely useful for a ton of stuff. Here is
  206. a list of all the statements that have not been discussed yet:
  207.  
  208.      DRAW
  209.      INPUT
  210.      PAUSE
  211.      PLAY
  212.      SOUND
  213.      QUIT
  214.  
  215. DRAW:  a graphics statement that interprets a string expression and
  216.        draws an object.
  217. Syntax:
  218.   DRAW stringexpression
  219.     ■ stringexpression is a one or more drawing commands.
  220.                              Drawing Commands
  221. ───Used to Draw a Line or Move the Current Graphics Position (CGP) or Both───
  222. B   Optional prefix - move, no line   │ N   Optional prefix - line, no move
  223. Un  Up             Dn  Down           │ Ln  Left             Rn  Right
  224. En  Up and right   Fn  Down and right │ Gn  Down and left    Hn  Up and left
  225. Mx,y  Move to screen point x,y (if x has a + or - in front, move is relative)
  226. ─────────────────────────────────Used to Color────────────────────────────────
  227. Cn  Change drawing (foreground) color │ Pp,b  Fill enclosed shape that has
  228.     (SCREEN mode determines 'n')      │       border color b with color p
  229. ────────────────────────────Used to Scale and Rotate──────────────────────────
  230. Sn  Increases or decreases length of  │ An   Rotate (n * 90) degrees,
  231.     moves (n=4 is default)            │      where n = 0, 1, 2, or 3
  232.                                       │ TAn  Rotate (0 >= n <= 360) degrees
  233.  
  234. The DRAW statement requires location not by LOCATE, but by adding to the
  235. commandline the "B" statement. For example:
  236.      To draw a triangle at 60,90 you would type:
  237.      
  238.      DRAW BR60 BD90 F5 E5 L10
  239.  
  240.  
  241. INPUT: Used to store input for the EXEC+INPUT statement. Can be used in
  242.     conjuncture with the LOCATE statement.
  243.  
  244. PAUSE: Pauses until a key is pressed, or for the specified amount of seconds.
  245.  
  246.      PAUSE 5 will pause for five seconds (or until a key is pressed)
  247.      PAUSE will wait until a key is pressed
  248.  
  249. PLAY:  a device I/O statement that plays music
  250.  
  251. Syntax:
  252.   PLAY commandstring
  253.     ■ commandstring is a stringexpression that contains music commands:
  254. ──────────────────────────Set Octaves and Play Tones──────────────────────────
  255.  On  Sets current octave (n = 0-6)    │  < or >  Up or down one octave
  256.  Nn  Plays note n (n = 0-84, 0 is a   │  A-G  Plays A, B, ..., G in current
  257.      rest)                            │      octave (+ = sharp, - = flat)
  258. ──────────────────────────Set Tone Duration and Tempo─────────────────────────
  259.  Ln  Sets length of a note (L1 is     │  MS  Each note plays 3/4 of length
  260.      whole note, L4 is quarter note,  │  MN  Each note plays 7/8 of length
  261.      etc.)  n = 1-64                  │  ML  Each note plays full length
  262.  Tn  Sets number of quarter notes per │  Pn  Pause for the duration of
  263.      minute (n = 32-255, 120 default  │      n quarternotes (n = 1-64)
  264. ────────────────────────────────Set Operation─────────────────────────────────
  265.  MF  Plays music in foreground        │  MB  Plays music in background
  266.  
  267. SOUND: Makes a beep from the PC Speaker
  268.  
  269. QUIT: Stops the program immediatley. It's only use is either to hide some
  270. programming or to stop the program from reaching some script so you can
  271. debug it.
  272.  
  273.  
  274. 2.3 Command Summaries
  275.  
  276. CLS: clear the screen
  277. BOX: draw a shadow box on the screen
  278. MODE: change Screen mode
  279. DISP: display text on the screen
  280. FCOLOR: change fore color
  281. BCOLOR: change back color
  282. LOCATE: change curser location
  283. EXEC: execute a command line
  284. EXEC+INPUT: execute a command line with input as a parameter
  285. DRAW: draw shapes on the screen
  286. INPUT: input information
  287. PAUSE: pause for n seconds or until a key is pressed
  288. PLAY: play music on the PC Speaker
  289. SOUND: make the PC Speaker beep once
  290. QUIT: end the script
  291.  
  292.  
  293. 3.0 License Agreements and Ordering Info.
  294.  
  295.     °FireZone Ent. is in no way responsible for any machine damage or data
  296. corruption caused by this program. If any damage occurs, it is the fault of
  297. the script writer. If the files are tampored with or infected by a virus,
  298. he/she that infects the files is subject to all penalties that may be
  299. incurred by the United States Government. All files are (C) Copyright 1996 by
  300. °FireZone Ent.
  301.  
  302. Order Form:
  303. -----------
  304.  
  305. Name (please print)________________________________________________________
  306.  
  307. Address ___________________________________________________________________
  308.  
  309. Address ___________________________________________________________________
  310.  
  311. City _______________________ St./Prov. _________________ ZIP/Code _________
  312.  
  313. Country (if not USA) ____________________ Phone/Fax _______________________
  314.  
  315. The Basic Installer: $9.00
  316.  
  317. Payment is by check only!
  318. Make checks payable to: Ethan Olson
  319. (He's the writer of the software, as well as the founder of °FireZone Ent.)
  320.  
  321. Mail to:  Ethan Olson
  322.          °FireZone Ent.
  323.           P.O. Box 360
  324.           Ashburnham, MA 01430
  325.